From 9a4e3371e2871128019a610ab369d1093f367d6b Mon Sep 17 00:00:00 2001 From: =?utf8?q?Javier=20Jard=C3=B3n?= Date: Sat, 24 Apr 2010 05:15:05 +0200 Subject: [PATCH] Remove GtkTooltips completely --- docs/reference/gtk/gtk-sections.txt | 25 --- docs/reference/gtk/gtk.types | 1 - docs/reference/gtk/tmpl/gtktooltips.sgml | 191 ----------------------- gtk/gtk.symbols | 16 -- 4 files changed, 233 deletions(-) delete mode 100644 docs/reference/gtk/tmpl/gtktooltips.sgml diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt index b4c703b4e9..315b74c063 100644 --- a/docs/reference/gtk/gtk-sections.txt +++ b/docs/reference/gtk/gtk-sections.txt @@ -4224,31 +4224,6 @@ gtk_toggle_tool_button_get_type GtkToggleToolButtonPrivate -
-gtktooltips -GtkTooltips -GtkTooltips -GtkTooltipsData -gtk_tooltips_new -gtk_tooltips_enable -gtk_tooltips_disable -gtk_tooltips_set_delay -gtk_tooltips_set_tip -gtk_tooltips_data_get -gtk_tooltips_force_window -gtk_tooltips_get_info_from_tip_window - - -GTK_TOOLTIPS -GTK_IS_TOOLTIPS -GTK_TYPE_TOOLTIPS -GTK_TOOLTIPS_CLASS -GTK_IS_TOOLTIPS_CLASS -GTK_TOOLTIPS_GET_CLASS - -gtk_tooltips_get_type -
-
gtktoolitemgroup GtkToolItemGroup diff --git a/docs/reference/gtk/gtk.types b/docs/reference/gtk/gtk.types index d85ae81fc3..417fca5bfb 100644 --- a/docs/reference/gtk/gtk.types +++ b/docs/reference/gtk/gtk.types @@ -166,7 +166,6 @@ gtk_tool_button_get_type gtk_tool_item_get_type gtk_tool_item_group_get_type gtk_tool_palette_get_type -gtk_tooltips_get_type gtk_tree_drag_dest_get_type gtk_tree_drag_source_get_type gtk_tree_get_type diff --git a/docs/reference/gtk/tmpl/gtktooltips.sgml b/docs/reference/gtk/tmpl/gtktooltips.sgml deleted file mode 100644 index 928950adfd..0000000000 --- a/docs/reference/gtk/tmpl/gtktooltips.sgml +++ /dev/null @@ -1,191 +0,0 @@ - -GtkTooltips - - -Add tips to your widgets - - - -#GtkTooltips has been deprecated in GTK+ 2.12, in favor of the new -#GtkTooltip API. - - -Tooltips are the messages that appear next to a widget when the mouse pointer is held over it for a short amount of time. They are especially helpful for adding more verbose descriptions of things such as buttons in a toolbar. - - -An individual tooltip belongs to a group of tooltips. A group is created with a call to gtk_tooltips_new(). Every tooltip in the group can then be turned off with a call to gtk_tooltips_disable() and enabled with gtk_tooltips_enable(). - - -The length of time the user must keep the mouse over a widget before the tip is shown, can be altered with gtk_tooltips_set_delay(). This is set on a 'per group of tooltips' basis. - - -To assign a tip to a particular #GtkWidget, gtk_tooltips_set_tip() is used. - - - -Tooltips can only be set on widgets which have their own X window and -receive enter and leave events. -To check if a widget has its own window use GTK_WIDGET_NO_WINDOW(). -To add a tooltip to a widget that doesn't have its own window, place the -widget inside a #GtkEventBox and add a tooltip to that instead. - - - -The default appearance of all tooltips in a program is determined by the current GTK+ theme that the user has selected. - - -Information about the tooltip (if any) associated with an arbitrary widget can be retrieved using gtk_tooltips_data_get(). - - - -Adding tooltips to buttons. - - GtkWidget *load_button, *save_button, *hbox; - GtkTooltips *button_bar_tips; - - button_bar_tips = gtk_tooltips_new (); - - /* Create the buttons and pack them into a GtkHBox */ - hbox = gtk_hbox_new (TRUE, 2); - - load_button = gtk_button_new_with_label ("Load a file"); - gtk_box_pack_start (GTK_BOX (hbox), load_button, TRUE, TRUE, 2); - gtk_widget_show (load_button); - - save_button = gtk_button_new_with_label ("Save a file"); - gtk_box_pack_start (GTK_BOX (hbox), save_button, TRUE, TRUE, 2); - gtk_widget_show (save_button); - gtk_widget_show (hbox); - - /* Add the tips */ - gtk_tooltips_set_tip (GTK_TOOLTIPS (button_bar_tips), load_button, - "Load a new document into this window", - "Requests the filename of a document. - This will then be loaded into the current - window, replacing the contents of whatever - is already loaded."); - gtk_tooltips_set_tip (GTK_TOOLTIPS (button_bar_tips), save_button, - "Saves the current document to a file", - "If you have saved the document previously, - then the new version will be saved over the - old one. Otherwise, you will be prompted for - a filename."); - - - - - - - -#GtkToolbar -Create groups of widgets with their own tooltips. - - -#GtkTipsQuery -Query tooltips to create context-sensitive help. - - - - - - - - -Holds information about a group of tooltips. Fields should be changed using the functions provided, rather than directly accessing the struct's members. - - - - - -tooltips is the #GtkTooltips group that this tooltip belongs to. widget is the #GtkWidget that this tooltip data is associated with. tip_text is a string containing the tooltip message itself. - -tip_private is a string that is not shown as the default tooltip. Instead, this message may be more informative and go towards forming a context-sensitive help system for your application. (FIXME: how to actually "switch on" private tips?) - - -@tooltips: -@widget: -@tip_text: -@tip_private: -@Deprecated: 2.12: - - - -Creates an empty group of tooltips. This function initialises a #GtkTooltips structure. Without at least one such structure, you can not add tips to your application. - - -@Returns: a new #GtkTooltips group for you to use. -@Deprecated: 2.12: - - - - -Allows the user to see your tooltips as they navigate your application. - - -@tooltips: a #GtkTooltips. -@Deprecated: 2.12: - - - - -Causes all tooltips in @tooltips to become inactive. Any widgets that have tips associated with that group will no longer display their tips until they are enabled again with gtk_tooltips_enable(). - - -@tooltips: a #GtkTooltips. -@Deprecated: 2.12: - - - - -Sets the time between the user moving the mouse over a widget and the widget's tooltip appearing. - - -@tooltips: a #GtkTooltips. -@delay: an integer value representing milliseconds. -@Deprecated: 2.12: - - - - - -@tooltips: -@widget: -@tip_text: -@tip_private: - - - - -Retrieves any #GtkTooltipsData previously associated with the given widget. - - -@widget: a #GtkWidget. -@Returns: a #GtkTooltipsData struct, or %NULL if the widget has no tooltip. -@Deprecated: 2.12: - - - - -Ensures that the window used for displaying the given @tooltips is created. - - -Applications should never have to call this function, since GTK+ takes -care of this. - - -@tooltips: a #GtkToolTips -@Deprecated: 2.12: - - - - - - - -@tip_window: -@tooltips: -@current_widget: -@Returns: -@Deprecated: 2.12: - - diff --git a/gtk/gtk.symbols b/gtk/gtk.symbols index 3d04a2153e..cd719dccb8 100644 --- a/gtk/gtk.symbols +++ b/gtk/gtk.symbols @@ -3837,22 +3837,6 @@ gtk_tooltip_trigger_tooltip_query #endif #endif -#if IN_HEADER(__GTK_TOOLTIPS_H__) -#if IN_FILE(__GTK_TOOLTIPS_C__) -#ifndef GTK_DISABLE_DEPRECATED -gtk_tooltips_data_get -gtk_tooltips_disable -gtk_tooltips_enable -gtk_tooltips_force_window -gtk_tooltips_get_info_from_tip_window -gtk_tooltips_get_type G_GNUC_CONST -gtk_tooltips_new -gtk_tooltips_set_delay -gtk_tooltips_set_tip -#endif -#endif -#endif - #if IN_HEADER(__GTK_TRAY_ICON_H__) #if IN_FILE(__GTK_TRAY_ICON_X11_C__) #ifndef G_OS_WIN32 -- 2.30.2